================================================================================
           TESLA-STYLE AUTOPILOT / FULL SELF-DRIVING (FSD) SYSTEM
================================================================================
  Version: 1.0
  Author: [vlaati]
  Platform: Grand Theft Auto V (PC)
  Requirement: ScriptHookV, ScriptHookVDotNet 3 (SHVDN3)
================================================================================

INTRODUCTION:
  Have you ever wanted to just sit back, relax, and let your vehicle drive you 
  through the chaotic streets of Los Santos? This mod brings a fully functional, 
  highly immersive Tesla-style Autopilot/FSD system directly to GTA V!

  Unlike other basic driving scripts, this mod uses an advanced navigation layer
  with a completely invisible ghost driver. The player is placed in the passenger 
  seat with 100% camera freedom—no locked perspectives, no jarring resets. 
  The AI will aggressively overtake slower traffic, swerve around stationary 
  cars, off-road to avoid lane blockages, and brake dynamically for pedestrians.

================================================================================
FEATURES:
================================================================================
  * REAL-TIME HUD: A high-tech HUD displaying speed, status (Standby/Engaged), 
    destination coordinates, remaining distance, and an accurate ETA countdown.
  * THREE DRIVING MODES:
    - SLOW: High caution. Obeys traffic lights and speed limits.
    - MEDIUM: Balanced. Ignores traffic lights, actively swerves around traffic.
    - FAST: Aggressive highway FSD. Ignores lights, overtakes wrong-way if 
      necessary, and drives at extreme speeds.
  * PHYSICAL OVERTAKING: The vehicle physically steers around traffic blockages
    rather than awkwardly stopping behind them.
  * PEDESTRIAN EMERGENCY BRAKING (AEB): The vehicle senses pedestrians in the 
    travel lane, slowing down and performing emergency stops if someone steps out.
  * TWO-STAGE SMOOTH ARRIVAL: The system detects the waypoint 2D coordinates, 
    gradually decelerating at 60 meters out, and engaging the handbrake for a 
    clean, perfect stop at 25 meters.
  * STUCK RECOVERY: Automatically reverses, steers, and recalculates pathing 
    if the car gets blocked or boxed in.
  * KEYBINDING CONFIGURATION: Fully customisable controls via the .ini file.

================================================================================
DEFAULT CONTROLS:
================================================================================
  [G]               - Enter closest vehicle as a passenger (while on foot)
  [SHIFT + Z]       - Toggle Autopilot HUD Panel
  [UP / DOWN ARROW] - Cycle Driving Mode (Slow / Medium / Fast)
  [ENTER]           - Start / Stop Autopilot
  [BACKSPACE / ESC] - Close Autopilot Panel

  *NOTE: All of these controls can be custombound to any key of your choice
   inside the "TeslaAutopilot.ini" configuration file!

================================================================================
INSTALLATION INSTRUCTIONS:
================================================================================
  1. Ensure you have the following prerequisites installed and working:
     - Script Hook V (by Alexander Blade)
     - Script Hook V .NET 3 (SHVDN3 v3.6.0 or higher)
     - .NET Framework 4.8 or higher
  2. Copy "TeslaAutopilot.dll" and "TeslaAutopilot.ini" 
     directly into your GTA V installation's "scripts" folder.
     (e.g., C:\Program Files (x86)\Steam\steamapps\common\Grand Theft Auto V\scripts)
  

================================================================================
CUSTOMISING THE .INI CONFIGURATION:
================================================================================
  Open "TeslaAutopilot.ini" in any text editor (like Notepad) to customize:
  * Keybinds: Change the HUD toggle, passenger entry, or menu keys using standard
    Windows keyboard enum names (e.g., Return, Space, G, X, F5).
  * Speeds: Alter the cruise velocity (in m/s) of the Slow, Medium, and Fast modes.
  * UI Position: Modify the X and Y coordinates to move the HUD anywhere on 
    your screen.
  * Arrival Settings: Customise how far away your car begins its slow-down and 
    final stop sequence.

================================================================================
KNOWN LIMITATIONS & BUGS:
================================================================================
  - Supported vehicles: Land vehicles only (Cars, Bikes, SUVs, Trucks). 
    Does not support planes, helicopters, or boats.
  - Waypoints: Always set your waypoint on a valid road or dirt path. Setting a 
    waypoint in the middle of the ocean or on top of an inaccessible mountain 
    will confuse the native road-node pathfinding.
  - Very tight alleys: The vehicle may trigger the stuck-recovery system more 
    often in congested alleys. It will reverse out and fix itself automatically.
  - Long distance pathing: If routing across the entire map, the AI might 
    occasionally select a slightly longer route due to GTA's native node memory.

================================================================================
CREDITS & PERMISSIONS:
================================================================================
  - Created by: [vLaati]
   - You are free to showcase this mod on YouTube/TikTok! Please link back to 
    the official download page.
================================================================================